home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / standard / stensize.z / stensize
Encoding:
Text File  |  1998-10-20  |  3.8 KB  |  67 lines
  1.  
  2.  
  3.  
  4. sssstttteeeennnnssssiiiizzzzeeee((((3333GGGG))))                                                      sssstttteeeennnnssssiiiizzzzeeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sssstttteeeennnnssssiiiizzzzeeee - specify the number of bit planes desired to comprise the
  10.      stencil buffer
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      vvvvooooiiiidddd sssstttteeeennnnssssiiiizzzzeeee((((lllloooonnnngggg ppppllllaaaannnneeeessss))))
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _p_l_a_n_e_s   is the number of bit planes requested to be configured as
  17.               stencil planes.  Only values 0 through 8 are accepted.  The
  18.               default is 0.
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      sssstttteeeennnnssssiiiizzzzeeee specifies how many bit planes are requested to be configured as
  22.      stencil planes.  The constraints on _p_l_a_n_e_s are machine dependent.  Call
  23.      ggggeeeettttggggddddeeeesssscccc((((GGGGDDDD____BBBBIIIITTTTSSSS____SSSSTTTTEEEENNNNCCCCIIIILLLL)))) to determine the maximum number of bit planes
  24.      available for stencil operation.
  25.  
  26.      sssstttteeeennnnssssiiiizzzzeeee takes effect only after ggggccccoooonnnnffffiiiigggg has been called.  The number of
  27.      bit planes granted for the stencil buffer may not be exactly what was
  28.      requested.  Call ggggeeeettttggggccccoooonnnnffffiiiigggg((((GGGGCCCC____BBBBIIIITTTTSSSS____SSSSTTTTEEEENNNNCCCCIIIILLLL)))) to determine how many bit
  29.      planes were configured as stencil buffer planes.
  30.  
  31.      Because stencil bit planes are available only in the normal framebuffer,
  32.      sssstttteeeennnnssssiiiizzzzeeee should be called only while draw mode is NNNNOOOORRRRMMMMAAAALLLLDDDDRRRRAAAAWWWW.
  33.  
  34. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  35.      drawmode, gconfig, getgconfig, stencil, mssize
  36.  
  37. NNNNOOOOTTTTEEEESSSS
  38.      This routine is available only in immediate mode.
  39.  
  40.      IRIS-4D B, G, GT, and GTX models, as well as the Personal Iris, Indy,
  41.      Iris Indigo Entry, and XL, do not support sssstttteeeennnnssssiiiizzzzeeee.
  42.  
  43.      XS, XS24, XZ, Elan and Extreme systems support up to 4 stencil planes,
  44.      which are borrowed from the Z buffer. The resolution of the Z buffer
  45.      decreases when using stencil planes on Elan systems.
  46.  
  47.      On the IRIS-4D RealityEngine models the stencil buffer and the stencil
  48.      component in the multisample buffer are independent.  When the
  49.      multisample buffer is requested in the current framebuffer configuration,
  50.      it is recommended to call sssstttteeeennnnssssiiiizzzzeeee((((0000)))), as no stencil buffer planes are
  51.      required.
  52.  
  53. BBBBUUUUGGGGSSSS
  54.      IRIS-4D VGX machines without the optional alpha bit planes allocate
  55.      stencil bit planes from the least-significant Z buffer bit planes.  Z
  56.      buffer operation compensates for this allocation automatically, so the
  57.      programmer is aware of the allocation only when the Z buffer contents are
  58.      read back using llllrrrreeeeccccttttrrrreeeeaaaadddd.  Use ggggeeeettttggggddddeeeesssscccc to determine whether your
  59.      machine has alpha bit planes.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.